Bookdown

Escrever livros nunca foi tĂ£o fĂ¡cil

Eduardo E. R. Junior - SeminĂ¡rios do LEG

17 de outubro de 2016

As devidas referĂªncias

O que Ă© o bookdown

Um pacote R que estende as funcionalidades do rmarkdown para escrita simples de livros e artigos longos.

  • MantĂ©m as funcionalidades do rmarkdown (sintaxe simples, vĂ¡rios formatos de saĂ­da, opções de chunk, etc.);

  • Adiciona a possibilidade de mĂºltiplas pĂ¡ginas html com referĂªncia cruzada para tabelas, figuras, equações, etc.;

  • Inclui um estilo de saĂ­da GitBook, formato elegante de livros html

Fazendo vocĂª se impressionar com uma simples ferramenta.

Porque o bookdown?

Usar Word?

Um parĂ¡grafo ok, dois pode ser, mais de dois …

Latex?

Muito melhor, mas quando precisar alterar algo em uma tabela por exemplo …

Markdown?

Simples e portĂ¡vel !!!

Bookdown!

Mecla a facilidade e portabilidade do Markdown com a elegĂ¢ncia de outputs em LaTeX e HTMLs

Alguns exemplos

PĂ¡gina inicial do bookdown https://bookdown.org/.

Como começar

Requisitos

Para elaborar um livro.

  1. Software R;
  2. Editor de arquivos rmarkdown - .Rmd (emacs, RStudio, etc.);
  3. Pacote bookdown;
  4. Uma distribuiĂ§Ă£o Latex, caso queira resultados em PDF.

Requisitos

Para publicar no GitHub Pages.

  1. InstalaĂ§Ă£o do Git;
  2. Uma conta no GitHub.

Formatos bookdown

Em arquivos .Rmd comuns adicione os outputs.


---
output:
  bookdown::gitbook: default
  bookdown::pdf_book: default
  bookdown::epub_book: default
---

Estrutura de um livro

Para elaboraĂ§Ă£o de livros costuma-se dividir os capĂ­tulos em arquivos.

.
├── _bookdown.yml
├── cap01.Rmd
├── cap02.Rmd
├── cap03.Rmd
├── cap04.Rmd
├── cap05.Rmd
├── cap06.Rmd
├── index.Rmd
└── _output.yaml

Estrutura de um livro

O conteĂºdo do arquivo _bookdown.yaml:


book_filename: "bookdown-demo"
chapter_name: "CapĂ­tulo "

O conteĂºdo do arquivo _output.yaml:


bookdown::gitbook: default
bookdown::pdf_book: default
bookdown::epub_book: default

Elementos de um documento

Imagens:

knitr::include_graphics("images/imagem")

Elementos de um documento

ReferĂªncia cruzada:

(\#key) -> \label{key}
\@ref(key) -> \ref{key}

Elementos de um documento

Citações (bibtex):

@LEG2016   -> \citet{LEG2016} -> "Leg (2016)"
[@LEG2016] -> \citep{LEG2016} -> "(Leg, 2016)"

Exemplos pessoais

Publicando seus livros

Servidores

Utilizando o GitHub Pages